HAL RNG IRQ Handler and Callbacks Functions Migration

This section provides information about the HAL RNG control functions migration.

Callbacks functions

Title

HAL1

HAL2

Error Callback 

void HAL_RNG_ErrorCallback(RNG_HandleTypeDef *hrng);

void HAL_RNG_ErrorCallback(hal_rng_handle_t *hrng);

Ready Data Callback / Generation Complete Callback 

void HAL_RNG_ReadyDataCallback(RNG_HandleTypeDef *hrng, uint32_t random32bit);

/* The random numbers are stored in the user provided buffer passed to the HAL_RNG_GenerateRandomNumber_IT function */
void HAL_RNG_GenerationCpltCallback(hal_rng_handle_t *hrng);

HAL RNG callbacks register and unregister functions

title

HAL1

HAL2

Register Error Callback 

HAL_RNG_RegisterCallback(&rng_handle,
                         HAL_RNG_ERROR_CB_ID,
                         USER_RNG_ErrorCallback);

HAL_RNG_RegisterErrorCallback(&rng_handle,
                              USER_RNG_ErrorCallback);

Register Generation Complete Callback 

HAL_RNG_RegisterReadyDataCallback(&rng_handle,
                                  USER_RNG_ReadyDataCallback);

HAL_RNG_RegisterGenerationCpltCallback(&rng_handle,
                                       USER_RNG_GenerationCpltCallback);

UnRegister Error Callback 

HAL_RNG_UnRegisterCallback(&rng_handle,
                           HAL_RNG_ERROR_CB_ID);

HAL_RNG_RegisterErrorCallback(&rng_handle,
                              HAL_RNG_ErrorCallback);

UnRegister Ready Data Callback 

HAL_RNG_UnRegisterReadyDataCallback(&rng_handle);

HAL_RNG_RegisterGenerationCpltCallback(&rng_handle,
                                       HAL_RNG_GenerationCpltCallback);

Related concept: Individual callback registration APIs replace global register and unregister functions

IRQ handlers

Note

The functions HAL_RNG_IRQHandler() have been unchanged.